.. :validated: 3.2.0

Установка глобального каталога
------------------------------

Модуль ГК может быть установлен во время продвижения первого КД.

Для этого достаточно установить пакет ``aldpro-gc`` и добавить ключ ``--setup_gc`` при вызове утилиты ``aldpro-server-install``.

Если роль глобального каталога не была установлена сразу, то ее можно добавить позднее на любой контроллер домена через портал управления на странице **Роли и службы сайта** → **Служба глобального каталога**. КД, которому будет назначена новая роль, автоматически обновит конфигурацию через полчаса.

Для форсирования установки роли на сервере необходимо использовать команды:

.. code-block:: bash

   sudo DEBIAN_FRONTEND=noninteractive apt-get install -q -y aldpro-gc
   sudo aldpro-gc --action install

Важно помнить, что для установки необходима роль глобального каталога. В противном случае, при очередном обновлении конфигурации сервер автоматически удалит модуль ГК.

.. important::

   Вне зависимости от процесса установки ГК (форсированной или по расписанию) текущий установщик глобального каталога вносит изменение в конфигурацию плагина ``Retro Changelog`` сервера 389ds. Чтобы это изменение было применено, необходимо выполнить команду ``sudo ipactl restart``.

Проверить работу глобального каталога после его установки можно командой:

.. code-block:: bash

   sudo aldproctl status --service=globalcatalog